Skip to content

feat(enterprise): enhanced whitelabeling and sso controls#4703

Closed
imrja8 wants to merge 1 commit into
Dokploy:canaryfrom
imrja8:feat/enhanced-whitelabeling-and-sso-controls
Closed

feat(enterprise): enhanced whitelabeling and sso controls#4703
imrja8 wants to merge 1 commit into
Dokploy:canaryfrom
imrja8:feat/enhanced-whitelabeling-and-sso-controls

Conversation

@imrja8

@imrja8 imrja8 commented Jun 26, 2026

Copy link
Copy Markdown

What is this PR about?

(Note: Closing #4668 in favor of this one to squash the Drizzle migrations and fix the 60k line diff. Also added a few performance optimizations based on the initial review).

Adds enterprise whitelabeling controls, SSO/sidebar feature toggles, self-hosted restrictions, and full license-based gating, all scoped to self-hosted instances with an active enterprise license.

Whitelabeling (Branding)

  • Server-renders title, favicon (inlined as base64 data URI), custom CSS, and full OG/Twitter meta tags in _document to eliminate the flash of default Dokploy branding on first paint
  • Adds metaDescription and ogImageUrl fields for social link previews
  • Adds per-section enable switches (Branding, Metadata & Links, Error Pages, Forgot Password, Appearance), disabled sections hide their fields in the UI and are not applied to the app
  • Adds a Forgot Password section: admin can set a password reset guide + support email; when configured, the login page's "Lost your password?" link shows the guide and a "Get Support" mailto button instead of linking to the Dokploy docs
  • SSR-prefetches public branding on login/register so logo and app name render on first paint without a flash
  • Removes the client-side WhitelabelingProvider (title/favicon/CSS now server-rendered)

SSO / Restrictions

  • Adds Hide Help Links, Hide Social Links, Hide SSO Login toggles
  • Moves Self-hosted Restrictions from the SSO page to the License page
  • Adds Feature switches on the License page to show/hide SSO and Whitelabeling in the sidebar

License gating

  • All enterprise features (whitelabeling, SSO, restrictions) are automatically treated as off when the license is inactive or enterprise is not enabled (hasValidLicenseForInstance)
  • Default state is off for all new fields, existing installs are unaffected until an admin explicitly enables each section

Sidebar

  • Reduces expanded sidebar width and prevents horizontal scroll when collapsed
  • Org name in the header now truncates instead of wrapping at narrower widths

Performance & Cleanup (New in this branch)

  • SSR Cache: Added a 60-second in-memory settingsCache in _document.tsx. This prevents the SSR branding logic from hammering the database on every single page load.
  • Clean Migrations: Squashed the 7 fragmented SQL migrations (0173-0179) and their massive 60k+ line JSON snapshots into a single 0173_squashed migration.

Checklist

  • Created a dedicated branch based on canary
  • Read CONTRIBUTING.md
  • Tested in local instance — all features verified end-to-end (SSR output confirmed via curl, DB state, both enable/disable directions)

Issues related (if applicable)

closes #4668

Screenshots (if applicable)

N/A

@imrja8 imrja8 requested a review from Siumauricio as a code owner June 26, 2026 20:05
@dosubot dosubot Bot added size:XXL This PR changes 1000+ lines, ignoring generated files. enhancement New feature or request labels Jun 26, 2026
@imrja8 imrja8 closed this Jun 27, 2026
@imrja8 imrja8 deleted the feat/enhanced-whitelabeling-and-sso-controls branch June 27, 2026 08:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request size:XXL This PR changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant